CF_ObjMerge Documentation v1.0
by Dan G. Switzer, II

Table Of Contents:


Introduction

<CF_ObjMerge> will merge multiple CF-based objects into one structure. With this tag you can merge queries, arrays, structures and any other valid ColdFusion variable into a single object. The object is stored as a structure and each key of the structure contains the value of the merged data.

This tag will help you to create WDDX packets by merging all the different data types into a single data type. It's also a great add-on when used in conjunction with <CF_ObjDump>—which is a tool for display a tree of any valid CF-based object.


Requirements

CF_ObjMerge requires the following:


Installation

To install CF_ObjMerge, do the following:

Attributes

Below is a listing of each attribute and an in-depth description of what the attribute is.
Attribute      Description
OBJECTS      A comma-delimited list of all the objects you'd like to merge into a single object. If any of the objects are invalid an error message will be returned. By default, CF_ObjMerge will create a list of objects based upon scopes that CF returns as structures—this makes easy to create a single structure which contains all valid variables accessible to the current script. This in combination with <CF_ObjDump> makes it very easy to debug applications.
OUTPUT      This attribute is used to define the name of the object to be returned to the calling template. The default variable returned is "cfObjMerge".

Examples

 
<CF_ObjMerge 
	OBJECTS="QueryName,ArrayName"
	OUTPUT="NewObject"
	>
This would create a structure named "NewObject" containing 2 keys—QueryName and ArrayName. The QueryName key would contain the results of the query "QueryName" and ArrayName key would contain the contents of the array "ArrayName."
 
<CF_ObjMerge>
This would create a structure named "cfObjMerge" which contains a key for each CF scope which is defined as a structure. In CF4.5, all scopes—except the client and server scopes—are returned as structures.


What's New

Listed below is the revision history for CF_ObjMerge. Please make sure to read this thoroughly before replacing older version of CF_ObjMerge.
v1.0
• First public release.




Disclaimers

CF_EzPassword is not guarenteed to work with every server. I have taken every precaution to make sure that CF_EzPassword works with every version of ColdFusion (version 4+ and higher) on the NT platform.

Before using CF_EzPassword for the first time, be sure that you read the below agreement. Use of CF_EzPassword implies that you have read and agreed to the below statments.

Risk of Use
You understand that this Custom Tag may have errors and may produce unexpected results. You agree that any use of this Custom Tag will be entirely at your own risk.

No Warranty
THIS CUSTOM TAG IS PROVIDED "AS IS" AND WITHOUT WARRANTY, EXPRESS OR IMPLIED. PENGOWORKS.COM SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTIES OR MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Limitation on Liability
IN NO EVENT WILL PENGOWORKS.COM BE LIABLE FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO ANY LOST PROFITS, LOST SAVINGS OR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES, WHETHER RESULTING FROM IMPAIRED OR LOST DATA, SOFTWARE OR COMPUTER FAILURE OR ANY OTHER CAUSE, EVEN IF ALLAIRE IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY OTHER CLAIM BY YOU OR FOR ANY THIRD PARTY CLAIM. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES SO THIS LANGUAGE MAY NOT APPLY. IN SUCH CASE, ALLAIRE'S LIABILITIES WILL BE LIMITED BY THE ABOVE LIMITATION OF REMEDIES PROVISION.